home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / vision / grafics / programm / picfib11 / doc / picfib_g.txt next >
Encoding:
Text File  |  1995-11-25  |  16.8 KB  |  360 lines
  1. PICFIB Dokumentation V1.1 1995.08.07 für PICFIB V1.1 vom 1995.08.07
  2.  
  3.  
  4.                      P I C F I B
  5.  
  6.                          von
  7.  
  8.                   A. Rosenberg (AR)
  9.  
  10. GEWÄHRLEISTUNG: Ich (AR) übernehme keinerlei Haftung für Schäden die
  11. während oder durch die Benutzung dieses Programmes entstehen. Ich habe
  12. versucht alle Fehler zu beseitigen und einige Bekannte haben in einer
  13. Betatestphase versucht die Restlichen zu finden.
  14.  
  15. VERTRIEB: Dieses Programm ist SHAREWARE. Sie dürfen es über einen Zeitraum
  16. von 30 Tagen testen. Wenn Sie es nützlich finden und es weiter benutzen
  17. wollen müssen Sie sich registrieren lassen. Wenn Sie dies unterlassen
  18. benutzen Sie eine Raubkopie. Es darf (und soll) kopiert werden und über
  19. Mailboxen verteilt werden, solange dafür keine Gebühren verlangt werden
  20. und das Paket komplett weitergegeben wird. Es darf zu Speicherzwecken oder
  21. für Übertragungen komprimiert und/oder kodiert werden. Komerzielle
  22. PD/Shareware Distributoren dürfen nicht mehr als 5 DM als Kopiergebühr
  23. verlangen.
  24.  
  25. REGISTRIERUNG: SHAREWARE heisst, man kann die Software kostenlos erwerben
  26. und testen ob sie seinen Bedürfnissen entspricht. Wenn diesen Programm Ihren
  27. Vorstellungen entspricht und Sie es weiter benutzen wollen müssen Sie sich
  28. registrieren lassen.
  29. Ich glaube ein Zeitraum von 30 Tagen reicht aus um sich zu entscheiden, ob
  30. man das Programm benutzen will oder nicht. Wenn Sie sich registrieren lassen
  31. erhalten Sie einen Code, der das Maximum von 10 Dateien aufhebt und den
  32. About Dialog beim Verlassen des Programmes nicht mehr erscheinen lässt.
  33. Weitere Informationen über die Registrierung entnehmen Sie bitte der Datei
  34. REGIST_G.TXT.
  35.  
  36. 1. Übersicht
  37.  
  38. 1.1 Was ist PICFIB?
  39.  
  40. PICFIB ist ein Akronym für "PICture FIle Browser" und ist ein kleines Hilfs-
  41. programm, das es erleichtert eine größere Menge an Bildern anzusehen. Die
  42. Idee dazu hatte ich nachdem ich mir die ATARI GEMINI CD-ROM gekauft hatte.
  43. Darauf befinden sich unter anderem Ordner mit mehreren Dutzend Bildern
  44. (ungefähr 450). Ich schaute mir einige davon an und schon am nächsten Tag
  45. wusste ich nicht mehr genau, was ich schon gesehen hatte und was noch nicht.
  46. Ausserdem war es immer sehr umständlich mittels 'Datei|Öffnen...' durch die
  47. Dateiliste zu blättern um eine Datei auszuwählen. Um dieses Problem zu
  48. lösen schrieb ich dieses Programm.
  49.  
  50. 1.2 Was macht PICFIB
  51.  
  52. Mit PICFIB können Sie sich eine Liste mit Bild-Dateien erstellen lassen indem
  53. Sie einfach einen Ordner auswählen. Jeder Datei werden 4 'tags' zugeordnet.
  54. ('tag'(englisch) = Etikett, Anhänger. Man sagt etwas ist 'tagged' wenn es
  55. irgendwie markiert, ausgewählt wurde. Ich kenne kein vernünftiges deutsches
  56. Wort das man dafür einsetzen könnte deshalb verwende ich das englische Wort
  57. 'tag' weiter.) Tag 1 wird vom Programm verwaltet und zeigt an, ob das
  58. entsprechende Bild schon angezeigt wurde. Die restliche 3 Tags stehen dem
  59. Benutzer zur Verfügung. Sie können damit ihre Lieblings-Bilder kennzeichnen
  60. und mit der Filter-Funktion nur diese ansehen. Natürlich können Sie diese
  61. Tags zusammen mit der Liste speichern und laden. PICFIB unterstützt die
  62. folgenden Bilder: 2,4,16,256 Farben/Graustufen. Sie können jedes Bild in
  63. jeder Auflösung ansehen, aber wenn Ihre Auflösung weniger Farben bietet
  64. als das Bild zur Anzeige benötigt, werden nur die wichtigsten Farb-Ebenen
  65. (Planes) angezeigt. Um die Anzeige von Farb/Graustufen Bildern im Mono-
  66. Chrom-Modus zu verbessern können Sie Dithering mittels Floyd/Steinberg
  67. einschalten. (Dithering ist ein Verfahren, das es erlaubt Farbbilder
  68. in Schwarz/Weiß darzustellen).
  69.  
  70.  
  71. 1.3 Hardware-Anforderungen
  72.  
  73. PICFIB sollte auf jedem ST-Kompatiblen Computer in jeder Paletten
  74. basierten Auflösung funktionieren (keine True-Color Unterstützung).
  75.  
  76.  
  77. 1.4 Die Grenzen von PICFIB
  78.  
  79. Wenn man Bilder mit mehr Farben als die gewählte Auflösung bietet ansehen
  80. will, so wird das Bild auf die Farbzahl der gewählten Auflösung
  81. konvertiert. Dabei ist es von der Video-Hardware abhängig ob das Bild
  82. nach der Konvertierung ansehnlich bleibt. Für photorealistische
  83. Bilder sollte man 256 Farben zur Verfügung haben. Auf einem Standard
  84. ST sehen solche Bilder in der niedrigen Auflösung häufig nicht gut aus.
  85. Wählen Sie in solchen Fällen die Monochrom-Auflösung, da
  86. hier die Darstellung von 256 Farb-Bildern besser ist, als in einer
  87. Auflösung mit 16 Farben. Sie können nur Bilder laden, die kleiner als
  88. 4096x4096 Pixel sind und für die Sie ausreichend Speicher besitzen um
  89. die Bilder zu laden.
  90.  
  91.  
  92. 1.5 Unterstützte Graphik-Formate
  93.  
  94. Extension   Beschreibung
  95.  
  96. IMG         GEM IMG Format (inklusive XIMG)
  97. PC1,PC2,PC3 DEGAS Format für alle ST Auflösungen (komprimiert/unkomprimiert)
  98. PCX         PC-Paintbrush Format der Firma ZSoft
  99. GIF         CompuServe's Graphics Interchange Format
  100. TIF         Tagged Image File Format 
  101.  
  102. Anmerkung zum TIFF Format:
  103. Das TIFF Format wurde von den Firmen Aldus und Microsoft definiert und
  104. mehrfach erweitert. Es ist sehr flexibel und es können neben dem 
  105. eigentlichen Bild(ern) diverse andere Informationen abgelegt werden.
  106. Diese Flexibilität hat nun dazu geführt, daß viele Bilder nicht 100% 
  107. dem TIFF Standard entsprechen, weil sich die Programmierer (aus 
  108. welchen Gründen auch immer) nicht an den Standard gehalten haben. So 
  109. soll es schon vorgekommen sein, daß ein Programm seine eigenen TIFF
  110. Dateien nicht mehr lesen konnte.
  111. Die von mir benutzte TIFF Library ist in dieser Hinsicht sehr exakt und 
  112. weigert sich z.B. TIFF-Dateien zu laden, wenn optionale Daten (die
  113. das Bild nicht betreffen) fehlerhaft sind. So sind mir während des
  114. Test einige solche Dateien untergekommen. Wenn Sie also auf eine Datei
  115. stossen, bei der sich PICFIB mit einer Fehlermeldung weigert eine TIFF
  116. Datei zu laden, dann bleibt Ihnen nur die Möglichkeit die TIFF-Datei
  117. mit einem dritten Programm in der Hoffnung abzuspeichern, das dieses
  118. Programm eine korrekte Datei erzeugt.
  119. Die TIFF-Bibliothek die ich benutzt habe wurde von Sam Leffler 
  120. geschrieben und wurde von Dieter Linde auf die Atari Platform 
  121. portiert. Weitere Details entnehmen Sie bitten der Datei TIFFCPRT.TXT.
  122.  
  123.  
  124. 2. Die Menuleiste von PICFIB
  125.  
  126. 2.1 Das File Menü
  127.  
  128. 2.1.1. Create List.. (Erstelle Liste)
  129.  
  130. Über diesen Menüpunkt erstellen Sie eine neue Datei-Liste. Es erscheint
  131. ein File-Selektor in dem Sie den Ordner auswählen in dem sich die Bild-
  132. Dateien aufhalten. Die Liste wird dann alle Dateien enthalten, die der
  133. eingegebenen Extension entsprechen. Abhängig von der Option 'Scan
  134. through subdirs' wird entweder nur das gewählte Verzeichnis oder der
  135. gesamte Verzeichnisbaum durchsucht. Für jedes Bild der Liste wird Tag 1
  136. gesetzt und der Tool-Dialog wird geöffnet.
  137.  
  138. 2.1.2. Load List.. (Lade Liste)
  139.  
  140. Wählen Sie diesen Menüpunkt um eine gespeicherte Liste zu laden. Die
  141. Standard Extension für Listen ist TXT, da sie nur einfachen Text enthalten.
  142. Der Inhalt der Listen-Datei wird zeilenweise gelesen. Der Tool-Dialog wird 
  143. geöffnet. Seit der Version 1.0a werden Text-Dateien geprüft, ob sie gültige
  144. PICFIB-Dateien sind. Das soll verhindern, daß irrtümlich andere TXT-Dateien
  145. geladen werden.
  146. Wenn Sie Listen laden, die von der Version 1.0 erzeugt wurden, erscheint die
  147. Abfrage "PICFIB signature not found. Continue?" (PICFIB Kennung nicht 
  148. gefunden). Antworten Sie mit "YES" um das Laden fortzusetzen. Speichern Sie 
  149. die Liste wieder ab, so wird die Kennung erzeugt. 
  150.  
  151. 2.1.3. Save List.. (Speichere Liste)
  152.  
  153. Wählen Sie diesen Menüpunkt um eine Liste zu speichern. Die Standard
  154. Extension für Listen ist TXT. Die 'Tags' zu den Bildern werden natürlich
  155. auch gespeichert.
  156.  
  157. 2.1.4 Export List.. (Exportiere Liste)
  158.  
  159. Mit dieser Funktionen können Sie die Liste in einem Format 
  160. abspeichern, so daß sie von anderen Programmen genutzt werden kann. 
  161. Zuerst folgt die Beschreibung des zugehörigen Dialoges, dann folgen 
  162. einige Beispiele, was man damit anfangen kann.
  163. Der Export-Dialog enthält eine Checkbox, mit der Sie den PICFIB-Header
  164. in die Export Datei aufnehmen können (Include PICFIB header). 
  165. Dies sollten Sie dann ankreuzen, wenn die neue Datei wieder von PICFIB 
  166. benutzt werden soll. In einem solchen Fall müssen sie als Zeilen-Prefix 
  167. genau 4 Zeichen eintragen und den Zeilen Suffix leer lassen. Tun Sie dies 
  168. nicht wird PICFIB Probleme haben die Liste richtig auszuwerten. Falls 
  169. eine spätere Version von PICFIB mehr als 4 Tags verwalten kann, ist 
  170. hier eine entsprechende Anzahl von Zeichen einzutragen.
  171. Mit der nächsten Checkbox entscheiden Sie, ob die Filter-Optionen beim 
  172. Erzeugen der Liste benutzt werden sollen (Use filter option). Nur wenn 
  173. diese Checkbox angekreuzt ist, haben die beiden Radio-Buttons eine 
  174. Bedeutung. Wenn Sie die normale Filter-Funktion benutzen (Normal 
  175. filter) werden genau diese Bilder als Liste gespeichert, die der 
  176. Filter Maske im Optionen Dialog (siehe 2.1.5) entsprechen. Mit der 
  177. Funktion negierter Filter (Negated filter) können Sie genau die Menge 
  178. an Bilder als Liste abspeichern, die der Filter Maske NICHT 
  179. entspricht. 
  180. In die beiden Eingabe-Felder können Sie jeweils einen Text schreiben, 
  181. der jeweils vor/nach dem Dateinamen des Bildes steht.
  182.  
  183. Beispiele: 
  184.     (X) steht für eine Checkbox, (*) für einen Radio-Button, 
  185.     ( ) heisst die entsprechende Option nicht auswählen
  186.  
  187. 1.) Erzeugen einer neuen PICFIB Liste, in der alle Bilder enthalten 
  188. sein sollen, die Tag 2 UND TAG 3 gesetzt haben. Diese Bilder sollen 
  189. in der neuen Liste alle Tag 4 gesetzt haben. 
  190.     -Kreuzen Sie im Optionen-Dialog die Tags 2 und 3 an und setzen Sie 
  191.     die Tag Verknüpfung auf AND.
  192.     -Wählen Sie Export List.. an und stellen Sie folgende Optionen ein:
  193.      (X) Include PICFIB header
  194.      (X) Use filter option
  195.      (*) Normal filter ( ) Negated filter
  196.     -Schließlich tragen Sie als Zeilen Präfix ein: "   +" (drei 
  197.     Leerzeichen, ein Plus-Zeichen)
  198.     -Drücken Sie OK und wählen Sie im folgenden Dialog einen 
  199.     Dateinamen.
  200.     
  201. 2.) Erzeugen einer Batch Datei, mit der alle Bilder die Tag 2 oder Tag 
  202. 4 gesetzt haben von einer CD ins Verzeichnis C:\BILDER kopiert werden 
  203. sollen.
  204.     -Kreuzen Sie im Optionen-Dialog die Tags 2 und 4 an und setzen Sie 
  205.     die Tag Verknüpfung auf OR.
  206.     -Wählen Sie Export List.. an und stellen Sie folgende Optionen ein:
  207.      ( ) Include PICFIB header
  208.      (X) Use filter option
  209.      (*) Normal filter ( ) Negated filter
  210.     -Tragen sie als Zeilen Präfix "copy " und als Suffix 
  211.     "C:\BILDER" ein.
  212.     -Drücken Sie OK und wählen Sie im folgenden Dialog einen 
  213.     Dateinamen, der die Extension BAT trägt.
  214.     -Nun können Sie diese BAT Datei in einer COMMAND Shell 
  215.     aufrufen und die entsprechenden Dateien werden kopiert.
  216.     
  217. 3.) Erzeugen einer Batch Datei, mit der alle Bilder die Tag 2 oder Tag 
  218. 4 NICHT gesetzt haben aus dem Verzeichnis C:\BILDER gelöscht werden 
  219. sollen. (Die Liste muß für das Verzeichnis C:\BILDER erstellt worden 
  220. sein!)
  221.     -Kreuzen Sie im Optionen-Dialog die Tags 2 und 4 an und setzen Sie 
  222.     die Tag Verknüpfung auf OR.
  223.     -Wählen Sie Export List.. an und stellen Sie folgende Optionen ein:
  224.      ( ) Include PICFIB header
  225.      (X) Use filter option
  226.      ( ) Normal filter (*) Negated filter
  227.     -Tragen sie als Zeilen Präfix "del " ein
  228.     -Drücken Sie OK und wählen Sie im folgenden Dialog einen 
  229.     Dateinamen, der die Datei BAT trägt.
  230.     -Nun können Sie diese BAT Datei in einer COMMAND Shell 
  231.     aufrufen und die entsprechenden Dateien werden gelöscht.
  232.  
  233. Falls Sie eine UNIX kompatible Shell benutzen müssen sie statt "copy" 
  234. und "del" die entsprechenden Kommandos eintragen (z.B. "cp" und "rm").
  235.  
  236. 2.1.5. Options.. (Optionen)
  237.  
  238. Es erscheint ein Dialog mit mehreren Checkboxes. Die ersten 4 Checkboxes
  239. entsprechen den 4 'Tags'. Wenn Sie hier eine entsprechende Nummer
  240. ankreuzen sehen Sie nur noch solche Bilder bei denen die entsprechenden
  241. Tags angekreuzt sind. 'Match all tags' bedeutet, daß bei einem Bild
  242. alle Tags mit den Angekreuzten übereinstimmen müßen, damit das Bild
  243. angezeigt wird. 'Match 1 tag' bedeutet, daß bei einem Bild wenigstens
  244. ein Kreuz mit den hier angekreuzten übereinstimmen muß, damit es angezeigt
  245. wird. Wenn Sie nur Bild sehen wollen, die Sie noch nicht gesehen
  246. haben, kreuzen Sie einfach Tag 1 an.
  247. Darunter befinden sich zwei weitere Checkboxes. 'Scan through
  248. subdirs' beeinflußt das Erstellen neuer Listen. Entsprechend wird beim
  249. Aufbau einer Liste nur das ausgewählte Verzeichnis oder der gesamte
  250. Verzeichnisbaum durchsucht. 'Dither pics if mono res' bewirkt, daß in
  251. monochromen Auflösung Farb- u. Graustufenbilder gedithered werden. Das
  252. nimmt natürlich Zeit in Anspruch, so seien Sie nicht beunruhigt wenn
  253. das Laufwerkslicht bereits aus, aber das System noch beschäftigt ist.
  254. Wenn Sie das Dithering ausgeschaltet haben und Farb/Graustufenbilder
  255. in monochrom ansehen so wird Ihnen die höchstwertige Plane angezeigt.
  256. Manchmal kann man so bereits einen ersten Eindruck von diesem Bild
  257. bekommen, aber meistens sieht es so nicht besonders gut aus.
  258.  
  259.  
  260. 2.2 Das View Menü
  261.  
  262. 2.2.1 First pic (Erstes Bild)
  263.  
  264. Wenn Sie diesen Punkt auswählen wird das erste Bild aus der Liste geladen
  265. und in einem Fenster angezeigt. Dieser Punkt ist nur verfügbar wenn Sie
  266. eine Liste erstellt oder geladen haben. Bitte beachten Sie, daß die
  267. Bilder entsprechend den Tags im Optionen-Dialog gewählt werden. Es kann
  268. also sein, daß Sie die Meldung 'Ende der Liste' erhalten wenn keine
  269. Bilder den Filter-Optionen entsprechen.
  270.  
  271. 2.2.2 Next pic (Nächstes Bild)
  272.  
  273. Wählen Sie diesen Punkt um das nächste Bild aus der Liste zu laden und
  274. anzuzeigen. Die Filter-Optionen werden benutzt.
  275.  
  276. 2.2.3 Prev pic (Vorheriges Bild)
  277.  
  278. Wählen Sie diesen Punkt um das vorherige Bild aus der Liste zu laden und
  279. anzuzeigen. Die Filter-Optionen werden benutzt.
  280.  
  281. 2.2.4 Jump to pic (Springe zum Bild)
  282.  
  283. Wählen Sie diesen Punkt um bei einem bestimmten Bild zu beginnen. Die
  284. Filter-Optionen werden benutzt.
  285.  
  286. 2.2.5 Single pic (Einzelnes Bild)
  287.  
  288. Über diesen Punkt können Sie ein einzelnes Bild laden. Die Liste oder
  289. andere angezeigte Bilder werden dadurch nicht beeinflußt.
  290.  
  291. 2.2.6 Tool dialog
  292.  
  293. Wählen Sie diesen Punkt um ein zusätzliches Fenster zu öffnen mit dem
  294. Sie komfortabel durch die Liste blättern können. Außerdem können Sie
  295. damit die Tags für jedes Bild verändern. Der rechte Button lädt das
  296. nächste Bild, der linke Button das vorherige. Darunter sehen Sie vier
  297. Checkboxes die den Zustand der Tags für dieses Bild entsprechen.  Sie
  298. können die Tags entsprechend Ihren Wünschen setzen und löschen.
  299. Beachten Sie daß Tag 1 nach jedem Ansehen des Bildes automatisch
  300. gelöscht wird. Wenn Sie mehr über die Filter-Optionen wissen wollen
  301. lesen Sie im Abschnitt 2.1.4 weiter. Sie können das Tool-Fenster
  302. wieder schließen, wenn Sie den Punkt erneut anwählen. Wenn das Fenster
  303. sichtbar ist, wird der Menüeintrag mit einem Häkchen versehen.
  304.  
  305.  
  306. 3. Tastatur-Funktionen
  307.  
  308. Einige Funktionen können zusätzlich mit der Tastatur durchgeführt 
  309. werden oder sind nur mit der Tastatur verfügbar.
  310.  
  311. -Die Tasten 1-4 ändern den Zustand des jeweiligen Tags
  312. -Die Taste UNDO schaltet zwischen der Standard Palette und der Palette 
  313. des Bildes hin und her. Dies kann dann nützlich sein, wenn ein Bild 
  314. sehr viele ähnliche Farbtöne enthält, so daß man nicht mehr sieht wo 
  315. sich die Maus befindet oder welchen Menu-Einträg man vor sich hat.
  316.  
  317.  
  318. 4. Verschiedenes
  319.  
  320. PICFIB wurde mit Turbo-C 2.0 auf einem Atari 260ST der auf 4MB
  321. aufgerüstet wurde und einem Falcon030 in einem Zeitraum von ca. 8
  322. Wochen entwickelt. Die gesamten C Sourcen belegen ca.150KB.  PICFIB
  323. wurde mit TOS 1.04, TOS 2.06, TOS 4.04, MagiC! getestet. Ebenfalls getestet
  324. wurden allen Auflösungen die ein Falcon bietet (ohne die 16-Bit Modi).
  325.  
  326. Bekannte Bugs: Bisher keine.
  327.  
  328. Wenn Sie mehr darüber wissen wollen, welche Fehler in der aktuellen
  329. Version behoben wurden, lesen Sie die Datei HISTORY.TXT.
  330.  
  331. 4.1 Die Zukunft von PICFIB
  332.  
  333. Wenn entsprechende Resonanz bei den Anwendern vorhanden ist, werde
  334. ich PICFIB sicherlich weiterentwickeln und pflegen. Geplant sind etwa
  335. weitere Bildformate (z.B. BMP, JPEG...) und eine Funktion, die aus
  336. einer Liste von Bildern ein Bild mit verkleinerten Bildern errechnet
  337. (Thumbnail-Format). In absehbarer Zeit wird es wahrscheinlich auch
  338. eine Windows Version geben (ist gerade in Arbeit).
  339.  
  340. 4.2 Bugs und Features
  341.  
  342. Anregungen und Error-Reports sind natürlich willkommen und erwünscht.
  343. Fehlermeldungen sollten folgende Angaben enthalten:
  344. - Rechnertyp ST/STE/TT/Falcon + Hardware (Memory,Grafikkarten,CPU-Upgrades..)
  345. - TOS Version
  346. - Residente Programme (TOSFIX,NVDI,GDOS,....)
  347. - geladene Accessories
  348. - Auflösung in der das Programm den Fehler produziert (Pixel (x*y),Farben)
  349. - Blitter aktiviert?
  350. - Tritt der Fehler reproduzierbar auf?
  351. - Möglichst detailierte Angaben über die letzten Benutzeraktionen vor
  352.   Auftreten des Fehlers
  353. - Die Fehlersymptome (Nachzeichenfehler, Bus-Error,...)
  354.  
  355. Sollte ein Bild beim Laden eine Programm-Absturz erzeugen, so sollte
  356. man versuchen, das Bild mit einem anderen Programm (z.B. GemView) zu
  357. laden. Sollte das Bild ok sein, aber mit meinem Programm nicht ladbar
  358. sein, so wäre mir sehr daran gelegen, wenn man mir das Bild zukommen
  359. lassen könnte. Meine Adresse finden Sie in REGIST_G.TXT.
  360.